home *** CD-ROM | disk | FTP | other *** search
/ Mac Magazin/MacEasy 8 / Mac Magazin and MacEasy Magazine CD - Issue 08.iso / Sharewarebibliothek / DFÜ / TTD 2.0.1 Demo / TTD 2.0.1 Demo Docs < prev   
Text File  |  1995-03-30  |  11KB  |  271 lines
  1. Touch Tone Decoder 2.0.1, Demo
  2.  
  3. Registering...
  4.  
  5. This demo recognizes all but three touch tones.  To get the full-featured
  6. version, which recognizes every touch tone, please register by sending
  7. $25 (US) cash, check or money order to:
  8.  
  9. Carl Huben
  10. 6929 Lee Crest Drive
  11. West Bloomfield, MI
  12. 48322
  13.  
  14. I'll send you the registered version via either: (please specify)
  15.  
  16. 1) US mail (on a double density disk)
  17. 2) Internet email (as a binhexed letter)
  18. 3) AOL email (attached to a letter) 
  19.  
  20. Sorry, I can't give out the source code.
  21.  
  22. -------------------------------- Begin Docs ----------------------------------
  23.  
  24. Touch Tone Decoder allows you to analyze a sound to determine whether 
  25. touch tones are present, and if so, which ones.  It also recognizes rings, 
  26. busy signals, and the dial tone.  Tones may be analyzed in real time, or 
  27. recorded and then decoded.
  28.  
  29. I don't think the program requires much documentation.  However, I should 
  30. mention a few important points:
  31.  
  32. *** Decoding
  33.  
  34. •  There are two decoding modes supported: asynchronous and real time.
  35.     - In asynchronous mode, pre-recorded sounds may be analyzed.  Sounds 
  36. can be loaded from AIFF files, pasted in, or recorded from within the 
  37. program.  The portion of the sample you wish to analyze must be 
  38. highlighted.  To decode the current selection, click the fourth button 
  39. from the left (or choose "transform" from the decoding menu).  The results 
  40. are displayed in the text window.  Analysis continues until either the end 
  41. of the selection is reached, or the stop button is pressed.
  42.     - In real time mode, decoding is performed on-the-fly starting when 
  43. the transform button is pressed, and continuing until the stop button is 
  44. pressed.
  45.  
  46. • You can toggle the recognition of certain classes of tones by 
  47. checking/unchecking the appropriate boxes to the right of the transform 
  48. button.  Here is why you might choose to do so:
  49.     - To prevent spurious recognition or tones you know will not be 
  50. present.
  51.     - To speed up the algorithm.  The algorithm runs fastest when only 
  52. touch tones are chosen.
  53.  
  54. •  You can set the sensitivity of the tone detection algorithm in the 
  55. preferences menu.  It is better to record louder tones than to increase 
  56. the sensitivity, since false positives can be a problem at the high 
  57. sensitivity setting.
  58.  
  59. *** Representation of Sounds / Making Selections
  60.  
  61. •  Touch Tone Decoder features a graph of the current recording's average 
  62. amplitude versus time in the small rectangle immediately below the 
  63. buttons.  The graph's function is two-fold: it allows the user to 'see' 
  64. where the tones are within the whole sample, and it also indicates what 
  65. portion of the sound is selected for playback or analysis. 
  66.  
  67. • To select a portion of the sound for playback or analysis, position the 
  68. I-beam cursor within the rectangle at one end of the selection,  click the 
  69. mouse button and, while keeping it down, move to the other end of the 
  70. desired selection, then let go of the button.  Your selection will be 
  71. highlighted.
  72.         -  NOTE: Double-click inside the rectangle to highlight the entire 
  73. sample.
  74.  
  75. *** Recording Sounds
  76.  
  77. •  Click the button with the red circle.  Once you do this, the old 
  78. recording (if there is one) is erased, and recording begins from the 
  79. default sound input device.  Recording continues until either the stop 
  80. button (it has a square in the middle) is clicked, or the sound buffer is 
  81. filled.
  82.  
  83. *** Playing Sounds
  84.  
  85. •  The portion of the sample you wish to play must be highlighted.  To 
  86. play the current selection, click the button with the green triangle.  
  87. Playing continues until either the end of the selection is reached, or the 
  88. stop button is pressed.
  89.  
  90. *** Loading/Saving Sounds
  91.  
  92. •  AIFF files can be loaded, provided they are 8 bit, monophonic samples at 
  93. 22 kHz.
  94.  
  95. •  Sounds may be saved (as AIFFs), in whole or in part, by choosing the 
  96. appropriate option from the file menu.
  97.  
  98. •  Sounds selections may also be copied (from the edit menu), and pasted 
  99. into the scrapbook or other applications.
  100.  
  101. *** Preferences
  102.  
  103. •  Sound buffer- the size of the recording buffer in seconds.
  104.  
  105. •  Sample rate- in versions 2.0.1 and up, the rate is fixed at 22 kHz.
  106.  
  107. •  Play though- if checked, sounds are played through the Mac's internal 
  108. speaker during a recording.
  109.  
  110. •  Volume- You can set the volume to one of four levels, or to the system 
  111. default.
  112.  
  113. •  Tone sensitivity- You can choose from three levels of tone sensitivity.
  114.  
  115. •  Colors- You can set the graph window foreground color, and the text 
  116. window foreground and background colors from the pop-up menus.
  117.  
  118. •  Record Protect- If checked, you will be warned before a recording is 
  119. overwritten or lost (for example, when quitting).
  120.  
  121. •  Text Protect- If checked, you will be warned before the text window is 
  122. closed.
  123.  
  124. •  Sound Creator- The four character creator ID used for sound files 
  125. created by Touch Tone Decoder.  The default creator is "SFX!"; any files 
  126. saved using this ID will be opened by SoundEdit when double clicked.
  127.  
  128. •  Text Creator-  The four character creator ID used for text files 
  129. created by Touch Tone Decoder. The default creator is 'ttxt';  any files 
  130. saved using this ID will be opened by TeachText when double clicked.
  131.  
  132. *** Miscellaneous
  133.  
  134. •    When you paste a sound into Touch Tone Decoder, the current sound (if 
  135. there is one) will be overwritten, and the buffer will be resized to the 
  136. length of the pasted sound.
  137.  
  138. •  The Command-Period key combination is equivalent to clicking the stop 
  139. button.
  140.  
  141. *** Problems
  142.  
  143. •  If the program fails to recognize tones, they probably aren't loud 
  144. enough.  Try increasing the tone sensitivity in the preferences menu, or 
  145. analyze louder tones.  If that fails, make sure you are selecting a 
  146. portion of the graph before pressing the transform button.
  147.  
  148. •  If you have other problems, please contact me either by mail or email 
  149. with a description of the problem.  I'll try to fix it in the next version.
  150.  
  151. *** Distribution and (lack of) Warranty
  152.  
  153.   No warranty is expressed or implied.  I am not responsible for loss of 
  154. data, time, money, life or other damages resulting from bugs or flaws in, 
  155. or misuse of, either directly or indirectly, Touch Tone Decoder 2.0.1.
  156.  
  157. *** Okay...
  158.  
  159. Thanks to everyone who's tested the program and made suggestions, but 
  160. especially Rustle Laidman, for his endless testing and great suggestions.  
  161. And of course, thanks very much to those who have registered.
  162.  
  163. If you have any bug reports, suggestions, and/or comments, I'd like to 
  164. hear from you.  My addresses are (in order of probable permanence):
  165.  
  166.   •  US Mail: CCH, 6929 Lee Crest Drive, West Bloomfield, MI, 48322
  167.   •  America Online: My user ID is CarlHuben
  168.   •  Internet: CarlHuben@aol.com
  169.  
  170. ***More information about signaling tones:
  171.  
  172. Touch Tones:
  173.  
  174. There are 16 touch tones.  Most phones can only produce twelve of these, 
  175. the familiar  0 through 9, #, and * tones.  There are, however, four other 
  176. touch tones, usually designated A, B, C, and D.  Some modems and special 
  177. purpose phones can produce these, but in general they are seldom 
  178. encountered.  The frequencies used for each touch tone are listed in the 
  179. table below.
  180.  
  181. In North America, the minimum touch tone length is 50 milliseconds; the 
  182. minimum separation between touch tones is also 50 milliseconds.  Touch 
  183. tones must follow these conventions to be processed accurately by the DTMF 
  184. Decoder application.
  185.  
  186.         1209   1336   1477  1633 
  187.         _____________________
  188. 697  |   1        2         3        A  
  189.         |                         
  190. 770  |   4        5         6        B  
  191.         |                         
  192. 852  |   7        8         9        C  
  193.         |                         
  194. 941  |   *        0         #        D  
  195.  
  196. Dial Tone:
  197.  
  198. The standard dial tone is a continuous signal composed of equal amplitude 
  199. 350 and 440 hz tones.
  200.  
  201. Rings:
  202.  
  203. There are two common types of rings, normal and PBX.  DTMF Decoder 
  204. recognizes both.  The normal ring is a tone containing an equal amplitude 
  205. mix of 440 and 480 hz tones.  It is on for two seconds, and off for four.  
  206. The PBX ring is spectrally identical to the normal ring, but is on for one 
  207. second, and off for three.
  208.  
  209. It may seem surprising that the ring sound is just another DTMF tone, 
  210. since it appears to chatter on and off during the actual ring 
  211. ("B-r-r-r-r-r-r-ing").  The reason for this is simple: the difference 
  212. frequency produced by the mixing of the two nearly equal frequencies that 
  213. make up the ring is 40 hz, and so the 'volume' of the mixture dips and 
  214. rises 40 times per second.
  215.  
  216. When DTMF Decoder encounters a ring when analyzing a recording, "RING" is 
  217. written to the text window.  It does not differentiate between the two 
  218. rings.
  219.  
  220. Busy Signals:
  221.  
  222. Similar to rings, there are three common signals that share the same 
  223. frequencies but differ in timing.  These are the busy, local reorder, and 
  224. toll congestion tones.  They are composed of (again, an equal amplitude 
  225. mix of) 480 and 620 hz tones.  The busy signal is on for half of a second, 
  226. and off for half of a second.  The other two are shorter in duration and 
  227. their off times are shorter, too.
  228.  
  229. ***History:
  230.  
  231. Version 1.0 released 10/7/93
  232.  
  233. Version 1.1 released 12/3/93
  234.  
  235.   • Snazzy finder icon added.
  236.   • Spinning cursor added to distract user during pauses.
  237.   • DTMF window comes up automatically after launch.
  238.   • Docs partially rewritten.
  239.  
  240. Version 1.2 released 12/16/93
  241.  
  242.   • Support for black & white.
  243.   • No longer requires System 7.0 or above.  I know for sure it runs on 
  244. 6.0.7 and above.
  245.   • No longer requires a sound input device.  This was something I just 
  246. forgot to fix 
  247.      earlier.
  248.   • Will run even if a printer is not chosen.
  249.   • Better color handling- allows user to customize the text and graph 
  250. window colors.
  251.   • Superfluous data removed from pict resources.
  252.   • Play-through option added.
  253.   • Algorithm sensitivity made user-adjustable.
  254.   • Volume may now be set internally, or set to system default.
  255.   • No longer clobbers sound manager when it returns to finder.
  256.   • Support for multiple monitors.
  257.   • Docs overhauled.
  258.  
  259. Version 2.0 released 1/27/94
  260.  
  261.   • New, assembly language decoding algorithm added.  Handles real-time 
  262. and asynch decoding.
  263.   • Graph window selection algorithm revamped.
  264.   • Support added for sound copy and paste.
  265.   • Color menus, dialogs added.
  266.   • New splash screen.
  267.  
  268. Version 2.0.1 released 4/1/95
  269.   • Fixed a major bug that caused it to flop on most of the newer macs.
  270.   • Sample rate is now fixed at about 22 kHz
  271.   • Fixed a small bug in AIFF load/paste routine.